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Abstract. We developed a new quick pseudo-3D photoionization code based on Cloudy |(Ferland et al. 1 998) 
and IDL (RSI) tools. The code is running the ID photoionization code Cloudy various times, 
changing at each run the input parameters (e.g. inner radius, density law) according to an angu- 
lar law describing the morphology of the object. Then a cube is generated by interpolating the 
outputs of Cloudy. In each cell of the cube, the physical conditions (electron temperature and 
density, ionic fractions) and the emissivities of lines are determined. Associated tools (VISNEB 
and VELNEB_3D) are used to rotate the nebula and to compute surface brightness maps and 
emission line profiles, given a velocity law and taking into account the effect of the thermal 
broadening and eventually the turbulence. Integrated emission line profiles are computed, given 
aperture shapes and positions (seeing and instrumental width effects are included). The main 
advantage of this tool is the short time needed to compute a model (a few tens minutes). 
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1. Introduction 



Most planetary nebulae are not spherically symmetric. Therefore 3D photoioniza- 
tion codes are very welcome. The problem with truly 3D codes (such as Mocassin, 
lErcolano et al. 20 03) is their large computing time, which makes it difficult to explore 
a large parameter space. Morisset et al. (2005) have developed a pseudo-3D code based 



on the ID photoionization code NEBU |(Pequignot et al. 2001) Some applications are 



discussed in Morisset et al. (2005)| and |Morisset and Stasinska. (2006) The advantages 



Q H l and limitations of pseudo-3D codes are discussed in those papers as well. 



Using the same approach as for NEBU_3D, we developed Cloudy-3D, a pseudo-3D 
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' code based on the widely used ID code Cloudy (Ferland et al. 1998) Here we describe 
\ the use of Cloudy _3D and give information on how to install the software. 
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. £h \ 2. Flow diagram of Cloudy _3D 

In the following we describe the various steps needed to compute a 3D model. 

• Definition of the morphology Define all the parameters that change with the 
angle using angular law, (e.g. the inner radius is defined as an ellipsoidal, the hydrogen 
density is proportional to 1/r ). 

• Prepare_Cloudy_in Generate of the N input files for Cloudy, according to the 
morphology and the definition of fixed parameters (e.g. the ionizing flux description, 
kept constant for each direction) 

- Inputs: Description of the constant and varying parameters (angular law) 

- Outputs: A set of N Cloudy input files 

• Cloudy .driver Run N times Cloudy, manage the output naming. 

- Inputs: A set of N Cloudy input files 

- Outputs: A set of N Cloudy outputs files (physical parameters, line emissivities, etc). 
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• Cloudy _3D Read the N outputs of Cloudy and interpolate into a 3D coordinates 
cube. 

- Inputs: A set of N Cloudy outputs files; the geometrical size of the coordinate cube 
(can be 2D for testing, can be a close-up on one part of the nebula) 

- Outputs: The 3D cube containing the Ne, Te, the emissivities of selected lines and the 
ionic fractional abundances in each cell. 

• VELNEB_3D (optional) Compute the line profiles given a velocity field. 

- Inputs: The description of the velocity field; the cube of emissivities and Te (could come 
from another 3D code) 

- Outputs: The emission line profile in each cell of the 3D cube. 

• VISNEB_3D Turn the nebula, generate the outputs like the emission maps (3 
colors), PV-diagrams, etc. 

- Inputs: The cube of emissivities and physical parameters (could come from another 
3D code); rotations to apply to the 3D data; optionally: cube of emission line profiles; 
position and size of apertures, seeing, instrumental resolution 

- Outputs: Surface brightness maps; diagnostic line ratios maps; emission line profiles 
through apertures, PV-diagrams. 



3. What do you need to run Cloudy _3D? 

• Cloudy (!), from G. Ferland 

• IDL (RSI) 

• Subversion (svn), used to download the package and to keep it synchronized with 
the ultimate repository version. 

• E_mail me (morisset@astroscu.unam.mx) to ask for an account to download the 
package. The website dedicated to Cloudy _3D is in its very beta version, you can register 
at 



http://132.248.L102/CloudyJD 



4. Further developments 

• The catalogue of emission line profile (see Morisset & Stasinska, this conference). 

• The present version of Cloudy _3D is asymmetrical (no longitude dependence), the 
next step of the development if to have a full 3D code. 

• Interfacing Cloudy _3D with SHAPE (W. Steffen, this conference) will give the pos- 
sibility to explore quickly the morphological parameter space. 

• Implementation of Cloudy _3D into a virtual observatory to allow users to run 3D 
models from the web and to access a database of the previously run models. 
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